home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / pp / pp-6.0 / examples / master / README-master < prev    next >
Encoding:
Text File  |  1991-11-05  |  4.9 KB  |  190 lines
  1. .de LP
  2. .in 0
  3. .sp
  4. ..
  5. .de IP
  6. .sp
  7. .in 0
  8. .in +5
  9. .ti -5
  10. .ta +5
  11. \\$1\t\c
  12. ..
  13. .de DS
  14. .sp
  15. .nf
  16. .in +3
  17. ..
  18. .de DE
  19. .sp
  20. .fi
  21. .in -3
  22. ..
  23. .LP
  24. %BEGIN(J)    
  25. This configuration is meant to be a simplistic Janet configuration. It
  26. does only the basics to get the system going. A proper janet site
  27. needs tables building directly from the nrs database.
  28. .LP
  29. This configuration relies on the grey book channel having been built.
  30. This should be built in conjunction with the unix-niftp package. The
  31. full channel and domain table should be built by the c-nrs processor
  32. in PP mode.
  33. %END(J)
  34. %BEGIN(I)
  35. The configuration presented here is intended to be that used by a
  36. "normal" internet site. This means that the site should have a direct
  37. IP connection to the Internet and make use of the DNS.
  38. %END(I)
  39. %BEGIN(L)
  40. The configuration presented here is intended to be that used by a
  41. a site with local smtp capability. The configuration will allow
  42. delivery to a few local users and send all remote traffic to a single
  43. host.
  44. %END(L)
  45. .LP
  46. This is intended to be a first step that will get messages delivered to
  47. a few selected people and make very little use of the more advanced
  48. features.
  49. .LP
  50. To configure this version for use, do the following.
  51. .nr Ct 0 1
  52. .IP \n+(Ct.
  53. Run make install in this directory. This will install the files in the
  54. correct places.
  55. .DS
  56. % ./make install
  57. .DE
  58. .IP \n+(Ct.
  59. Edit the installed tailor file (%TAILOR%) to configure the site specific
  60. parameters near the beginning of this file.
  61. .DS
  62. % vi %TAILOR%
  63. .DE
  64. .IP \n+(Ct.
  65. Add the contents of the file isoentities.add to your system wide
  66. isoentities file (usually either in /usr/etc). You will probably need
  67. to be root to do this step.
  68. .DS
  69. % su
  70. Password:
  71. # vi /usr/etc/isoentities
  72. .DE
  73. This step is useful as a backup anyway, but if you have all your
  74. applications registered in the X.500 directory, you should add such an
  75. entry to that too. A sample entry is given in x500.sample. This should
  76. be added (after editing) at the same position as your other local applications.
  77. .DS
  78. % dish -u <manager>
  79. Welcome to Dish (DIrectory SHell)
  80. Enter password for "<manager>":
  81. Dish -> moveto cn=<machine>
  82. Dish -> add "cn=pp qmgr" -objectclass "applicationEntity & quipuObject"
  83. .DE
  84. .IP \n+(Ct.
  85. Change directory to the tables directory (%TABLES%).
  86. .DS
  87. % cd %TABLES%
  88. .DE
  89. .IP \n+(Ct.
  90. Edit the users file and add a few local users using the format
  91. given in that file.
  92. .DS
  93. % vi users
  94. .DE
  95. .IP \n+(Ct.
  96. Edit the ch.local file and add the same users to that file.
  97. .DS
  98. % vi ch.local
  99. .DE
  100. %BEGIN(J)
  101. .IP \n+(Ct.
  102. Edit the channel and domain table and make the changes suggested
  103. there.
  104. .DS
  105. % vi channel domain
  106. .DE
  107. %END(J)
  108. %BEGIN(L)
  109. .IP \n+(Ct.
  110. Edit the channel and domain tables. In particular replace the strings
  111. LOC-DOM-MTA, LOC-DOM-SITE and SMTP-RELAY with suitable hostnames.
  112. .DS
  113. % vi channel domain
  114. .DE
  115. %END(L)
  116. .IP \n+(Ct.
  117. Run dbmbuild (found in directory %CMDDIR%).
  118. .DS
  119. % %CMDDIR%/dbmbuild -v
  120. .DE
  121. .IP \n+(Ct.
  122. Run ckconfig (found in the directory %CMDDIR%) and see if everything looks
  123. reasonable.
  124. .DS
  125. % %CMDDIR%/ckconfig
  126. .DE
  127. .IP \n+(Ct.
  128. Start the pptsapd and the qmgr
  129. .DS
  130. % %CMDDIR%/pptsapd >& /dev/null
  131. % %CMDDIR%/qmgr >& /dev/null
  132. .DE
  133. .IP \n+(Ct.
  134. Add an appropriate line to the /etc/inetd.conf file to allow smtp
  135. incoming connections. An example might be
  136. .DS
  137. smtp stream tcp nowait pp /usr/pp/cmds/chans/smtpsrvr smtpsrvr smtp
  138. .DE
  139. After this you will need to do a kill -HUP on the inetd process to get
  140. it to reread the configuration file.
  141. If you are running another smtp service (e.g sendmail), make sure this
  142. is no longer running.
  143. .DS
  144. % su
  145. Password:
  146. # vi /etc/inetd.conf
  147. # ps -x
  148. # kill -HUP <pid>
  149. .DE
  150. .LP
  151. PP should now be ready for use. At this point it is worth testing out
  152. a few things. Some simple tests are as follows:
  153. .LP
  154. Submit a message to local user you configured in and see if it is
  155. delivered. This is easiest done by using the PP supplied mail program.
  156. This is normally installed in the %CMDDIR% directory. A command such as
  157. .DS
  158. % %CMDDIR%/mail -s test pp < /etc/motd
  159. .DE
  160. is a good start.
  161. .LP
  162. Submit a message to some other local machine using the same syntax as
  163. above.
  164. .LP
  165. If that works too, try a message to someone further afield. Use the
  166. same method, just pick a remote address for testing.
  167. .LP
  168. This configuration is meant only to get you started. Once this is
  169. running you will almost certainly want to do some of the following.
  170. .IP o
  171. Add all your users to the users and ch.local table by means of some
  172. shell/awk script from local databases.
  173. .IP o
  174. Create some lists to be expanded by the list channel.
  175. .IP o
  176. Rebuild the domain and channel tables to take account of local knowledge.
  177. .IP o
  178. Add in the ability to use X.400. This is at present rather too
  179. complicated to automate.
  180. %BEGIN(J)
  181. .IP o
  182. For the addressign of all sites on JANET, you should process the nrs
  183. database. There is a program available to do this, c-nrs. It is
  184. available from pb@cam.cl and has a PP mode which will produce suitable
  185. output for PP.
  186. %END(J)
  187. .LP
  188. Full details for all these procedures are laid out in Volume 1 of the
  189. PP manual.
  190.